
Protecting a file against changes using the 


ATTRIB command 

I f your computer has a hard drive, you’ll likely keep 
dozens (or even hundreds) of hies stored on that 
drive. Some of those hies will change on a regular 
basis, such as the ones that store your personal tele¬ 
phone directory and your company’s organizational 
chart. On the other hand, some of the hies on your 
hard disk will probably never change or be removed, 
such as an application program hie or last year’s 
income statement. 

Because you’ll want to prevent changes or modihca- 
tions to some of the hies on your hard disk, you might 
want to take advantage of the ATI’RIB command’s ability 
to protect a hie against unwanted changes. In this article, 
we’ll show you how to use the ATTRIB command for this 
purpose, and mention a few situations in which hie pro¬ 
tection is useful. 

Displaying a file’s read-only status 

Unfortunately, you can’t determine whether a hie is 
read-only by using the DIR command. Instead, you’ll 
need to use the ATTRIB command to bring up this infor¬ 
mation. To view the status of the read-only attributes for 
all the hies in the current directory, issue the command 

C: \DATA>attrib *.* 

Immediately, DOS will display a listing like this: 

A C : \DATA\BUDGET90 . WKl 

A R C: \DATA\INCOMES 9 . WKl 

A R C:\DATA\SALES89.WK1 

The letter/? that appears next to the hies INCOME89.WK1 
and SALES89.WK1 tells you that those hies are read-only, 
and therefore can’t be modihed or deleted. In DOS jar¬ 
gon, a hie that you can’t modify has its read-only atti'ibute 
turned on, while a hie that you can modify has its read¬ 
only attribute turned off. 

As you might guess, you can view the read-only 
status of a particular hie or group of hies by simply 
following the word attrib with the appropriate hle- 


name or hlename descriptor. For instance, to view the 
read-only status of the hies whose extensions are EXE, 
use the command. 

C: \>attrib *.exe 

Immediately, DOS will display the status of the current 
directory’s EXE hies. 

Making a file read-only 

To make a hie read-only—that is, to protect a hie 
against any attempts to change it or delete it—issue 
the command 

attrib +r filename 

where filename is the name of the hie you want to 
protect. 

Once you’ve used the AITRIB command to turn on 
a hle’s read-only attribute, attempting to remove that hie 
from your disk using the DEL or ERASE command will 
generate the message 

Access denied 

Continued on page 12 
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Listing files by name or by size 

Here’s a simple tip 1 use all the time. As you know, 
the DIR command doesn’t list files in alphabetical 
order. As a result, it’s a real pain to issue the DIR com¬ 
mand, and then to scan the directory listing carefully to 
find the paiticular file (or directory) you’re looking for. 
To overcome this problem, 1 use the command 

Odir I sort 

to view the directory listing in alphabetical order. That 
way, 1 can quickly scan down the listing and identify the 
desired entry. 

When 1 want to print a directory listing in alphabeti¬ 
cal order, I use the command 

Odir I sort > prn 

I find these two commands extremely helpful—I 
hope your readers do too. 

Frances Henderson 
Addison, Illinois 

Ms. Henderson’s techniques are handy for generat¬ 
ing listings from A to Z. If you want, however, you 
can use a similar form of the DIR command in conjunc¬ 
tion with the SORT filter to list entries from Z to A. To do 
this, issue the command 
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Odir I sort /r 

In addition to listing files alphabetically, you may 
sometimes want to list files by size. This is particularly 
useful when you need to delete some files from your 
hard disk to make some room. To list files by size from 
smallest to largest, use the command 

Odir I sort /+16 

To list them from largest to smallest, use the command 

Odir I sort /r /+16 

As Ms. Henderson pointed out, you can send a di- 
rectoiy listing to the printer any time you want by ap¬ 
pending the suffix > prn to the command. Additionally, 
you can view the listing one screen at a time by append¬ 
ing the suffix I more. For example, to view an alphabeti¬ 
cal listing of files one screen at a time, use the command 

Odir I sort | more 

Incidentally, all of these commands use piping (|) 
and/or redirection ( >). In a future issue oiInside DOS, 
we ll explain piping and redirection in detail. I 
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MAINTENANCE TIP 


Replacing your computer’s batteries 


D id you know that your computer uses batteries? 
Ever since IBM introduced the PC-AT back in 
1986, most personal computers have used bat¬ 
teries for two important tasks: 

1) to keep the computer’s internal system clock run¬ 
ning when the computer is turned off 
2) to power the memory that stores the computer’s 
configuration settings, such as the type of disk 
drives installed, the amount of base memory and 
extended memoiy, and the type of display 

If you’re not sure whether your computer uses bat¬ 
teries, here’s an easy way to make the determination: 
Simply turn your computer off and back on again. If the 
computer’s date and time reset to a particular date when 
you do this, the computer probably doesn’t use batter¬ 
ies; if the date and time stay current, however, the com¬ 
puter uses batteries. 

Of course, your computer’s batteries will eventually 
run down and need to be replaced. Wlien this happens, 
the computer will lose track of the date and time as well 
as its configuration settings the next time you turn off 
the computer. 

Depending on how often you power down your 
machine, most computer batteries last at least three 
years. Consequently, if your system is over three years 
old, you should buy a new set of batteries and replace 
the olds ones. Here are the basic steps necessary to 
replace your computer’s batteries: 

• record your computer’s configuration settings 
• remove the cover and replace the batteries 
• turn on your computer and restore the 
configuration settings 

Let’s discuss each of these steps in a little more de¬ 
tail. By the way, if you use an IBM PS/2 computer, the 
technique you’ll use is a little different from that for 
other PCs—more on that in a moment. 

Recording the configuration 
settings 

Before you remove the computer’s old batteries (or 
before they run down), you need to bring up and record 
the computer’s configuration settings. The method you 
use to bring up your computer’s configuration settings 
depends on the brand and model of the computer 
you’re using. As we noted earlier, some computers don’t 
even use batteries—instead, they have a set of DIP 
switches on the motherboard that specify the compu¬ 
ter’s configuration. 


If you’re using an IBM PC-AT, you 'll specify configu¬ 
ration settings by inserting the Setup and Diagnostics 
disk into drive A and rebooting your machine (the Setup 
and Diagnostics disk is stored in a plastic sleeve near the 
back of your computer’s setup documentation). When 
the staitup screen appears, choose Run Setup to bring 
up the computer’s configuration settings. 

If you're using an IBM-compatible computer (like 
Dell, Northgate, or Zeos), you’ll bring up the computer’s 
configuration screen either by using the computer’s con¬ 
figuration disk, or by pressing a key sequence like 
[Ctrl] [Alt] [Enter] or [Ctrl][Alt][Esc|. 

Once you’ve figured out how to bring up your 
computer’s configuration settings, write them down—all 
of them. You’ll see all kinds of settings for the date and 
time, diskette drives, hard disks, base memory, extended 
memory, display type, and so forth. Make absolutely cer¬ 
tain you record all the detailed information regarding 
your hard drive—if your computer permanently loses 
this information, you may not be able to access that 
drive. Even worse, if you later key in the wrong informa¬ 
tion for your hard drive, you can permanently damage 
that drive. 

Removing the computer’s cover 
and replacing the batteries 

Replacing the batteries in your computer isn't as easy as 
replacing the batteries in your flashlight, but it’s still 
pretty easy. Your computer owner’s manual should offer 
step-by-step instrtictions (often accompanied by lots of 
neat, little sketches) for replacing the computer’s batter¬ 
ies. Essentially, all you have to do is: 

• turn olf your computer 

• remove the screws that hold the computer’s 
cover in place 

• remove the old batteries 

• install the new batteries 

• replace the computer's cover and re-insert 
the screws 

If you’ve never removed the cover of your computer 
before, you'll probably want to enlist the help of a PC 
support specialist. The entire procedure should require 
no more than fifteen minutes. 

Of course, your manual should tell you what kind of 
batteries your computer uses. If you can’t find your 
owner’s manual, or if the manual doesn’t specify the 
type of batteries rec^uired, take your existing batteries to 
a focal computer store and ask someone to help you find 
the appropriate replacements. 


December 1990 ♦ 3 




Restoring the configuration 
settings 

Once you have installed new batteries and have replaced 
the computer’s cover, you’ll need to restore the com¬ 
puter’s configuration settings, which were lost as soon as 
you removed the old batteries. To restore those settings, 
turn on your computer and use the same method you 
used before to access your computer’s configuration 
screen. Once that screen appears, type in all the informa¬ 
tion exactly as you’ve recorded it. When you’re finished, 
press the appropriate key to save your new settings and 
reboot the computer. At that point, your computer 
should boot up and once again operate normally. 

For IBM PS/2 users 

Setting up the configuration for an IBM PS/2 computer 
is somewhat different from setting up most other com¬ 


puters. If you’re using an IBM PS/2, you won’t need to 
write down your computer’s configuration settings be¬ 
fore you change its batteries. Instead, you can replace 
the batteries, and then let the computer’s Reference 
Disk do the rest of the work for you. Simply insert the 
computer’s Reference Disk into drive A and reboot the 
machine. Wlien you see the Automatically 

configure the system? (Y/N), simply press j'. The Refer¬ 
ence Disk is nearly always smart enough to figure out 
what kind of equipment is installed on the computer, 
and can automatically set up the proper configuration. 

However, if your computer is equipped with some 
special peripherals and device drivers, the Reference 
Disk may not be able to configure your system automati¬ 
cally. Instead, you’ll need to follow the instmctions in 
your owner’s manual for configuring your machine. For 
more information on configuring an IBM PS/2, consult 
your local PC support specialist. I 
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Copying all files except those you specify 


As you know, the COPY and XCOPY commands 

allow you to copy to another disk or directory only 
JL jL the group of files you specify. For instance, you 
can copy all the files in the current directoiy whose ex¬ 
tensions are DBF to drive A using either of the following 
commands: 

copy *.dbf a: 
xcopy *.dbf a: 

However, what can you do when you want to copy 
all the files in the current directoiy except those with a 
particular extension? For instance, suppose the current 
directoiy contains a group of very large files whose 
extensions are DBF, and you want to copy to another 
drive all the files except those with DBF extensions. 

In this article, we’ll explain a technique that uses 
simple DOS commands to copy all the files except those 
you specify. Then, we’ll show you how to create a batch 
file that lets you perform this type of copy with a single 
command. 

The technique 

Our technique for copying all the files in the current 
directory except those you specify is as follows: First, 
you turn on the archive attribute for all the files in the 
current directory using the command: 

attrib +a *.* 

Next, you turn off the archive attribute for those files you 
do not want to copy using the command 


attrib -a fileDescriptor 

where fileDescriptor is the group of characters and 
wildcards (such as '^DBF) that specify those files. Finally, 
you copy those files whose archive attribute is turned on 
using the command 

xcopy *.* destination /m 

where destination is the destination drive and/or direc¬ 
tory. Let’s demonstrate this technique with a simple ex¬ 
ample. 

An example 

Suppose you want to copy to drive A all the files in the 
directoiy C:\MYI^ROG except those with DBF filename 
extensions. To do this, move into the C:\MYPROG direc¬ 
tory, and turn on the archive attribute for all the files in 
that director}^ using the command 

C : \MYPROG>attrib +a * . * 

Next, turn off the archive attribute of the files whose ex¬ 
tensions are DBF using the command 

C: \MYPROG>attrib -a *.dbf 

Finally, copy to drive A all the files whose archive at¬ 
tribute is still on using the command 

C: \MYPROG>xcopy *.* a: /m 
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As soon as you do this, DOS will begin copying files from 
the source directory to drive A. 

If all the hies you specify will ht onto drive A, you’ll 
see the DOS prompt again as soon as the last hie is cop¬ 
ied. However, if the disk in drive A can’t hold all of the 
source hies, DOS will copy as many hies as it can, then 
present the message 

Insufficient disk space 

and return you to the prompt. However, because you’ve 
used the Im option in the XCOPY command (which tells 
DOS to turn off each hle’s iittribute as soon as it copies 
the hie) you can continue copying the rest of the hies by 
replacing the diskette and reissuing the command 

C: \MYPROG>xcopy *.* a: /m 

Continue replacing diskettes and reissuing this com¬ 
mand until DOS hnishes copying all the source hies. At 
that point, if you check the target diskettes, you’ll see 
that DOS has copied all the hies in the directory 
C:\MYPROG except those with DBF extensions. 

Placing the commands in 
NOCOPYBAT 

Although the copying technique we’ve explained works 
well, you’ll want to make things easy for yourself by us¬ 
ing the batch hie NOCOPY.BAT, which is shown in Fig¬ 
ure A. Once you’ve created this batch hie and copied it 
into a directory whose name is on the path, here’s how 
you use it to perform the copy: Simply move into the 
directory that contains the source hies, then issue the 
command 

nocopy fileDe script or destination 

where fileDesanptor is the group of characters and 
wildcards that describe the hies you don’t want to copy, 
and destination is the destination drive and/or directory. 
Let’s see how this batch hie works line by line. 

Figure A 


@echo off 
attrib +a *.* 
attrib -a %1 
xcopy *.* %2 /m 


NOCOPY.BAT lets you copy all the files except those you specify. 

As you probably know, the hrst command in this 
batch hie 

@echo off 


tells DOS not to display the batch hle’s commands as it 
executes them. The second command in this batch hie 

attrib +a *.* 

tells DOS to turn on the archive attribute for every hie in 
the current directory. The next command 

attrib -a %1 

uses the replaceable parameter %1 to collect the 
fileDescriptor argument you supplied on the command 
line, and tells DOS to turn off the archive attribute for 
the hies specihed by this argument. The last command in 
the batch hie 

xcopy *.* %2 /m 

uses the replaceable parameter %2 to collect the destina¬ 
tion argument you typed on the command line, and tells 
DOS to copy to that destination all the hies whose 
archive attribute is turned on. 

An example 

To demonstrate how the NOCOPY.BAT hie works, let’s 
use this batch hie to perform the same task we per¬ 
formed earlier. That is, let’s copy to drive A all the hies in 
the directory C:\MYPROG except those with DBF hle- 
name extensions. To do this, move into the directoiy 
C:\MYPROG, and issue the command 

C: \MYPROG>nocopy *.dbf a: 

As soon as you issue this command, DOS will begin 
copying the source hies to drive A. 

If the diskette in drive A isn’t large enough to hold 
all the source hies you’ve specihed, you can’t copy the 
rest of the hies by simply rerunning NOCOPY.BAT. In¬ 
stead, you’ll need to replace the diskette in drive A and 
issue the command 

C: \MYPROG>xcopy *.* a: /m 

as we did before. Continue swapping disketes and reis¬ 
suing this command until DOS successfully copies all the 
source hies to drive A. 

Conclusion 

In this article, we’ve shown you a technique for copy¬ 
ing all the hies in a directory except for those you 
specify. Although our examples showed you how to 
use our technique to copy hies to drive A, you can use 
this technique to copy hies to any destination drive or 
directory. I 
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This article was written by Contributing Editor Van 
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Running MS-DOS and Supercharging MS-DOS. 


Getting to know a handy batch file tool: 
the IF command 


As ad writers love to tell us, the uses of a eomputer 
Z^are limited only by our own imagination. We can 
JL jL, write novels or marketing proposals, plan bud¬ 
gets or keep fantasy football statistics, design houses or 
lay out weaving patterns. But it takes more than imagina¬ 
tion, of course: We’ve got to learn how to use the pro¬ 
grams that make a computer something more than a 
very expensive paperweight. 

The better we learn to use application programs— 
word processors, for example, and spreadsheets and 
graphics programs—the more uses we find for these 
marvelous machines. Even if we buy a computer for one 
specific purpose, learning and using an application pro¬ 
gram almost always leads us to discover new uses. We 
need knowledge and experience to liberate our imagina¬ 
tions; the ad writers don’t tell us that. 

But somehow, in the rush to learn how to use pro¬ 
grams, there’s one program that everyone uses but not 
everyone learns how to use. It’s DOS, of course, and like 
any other program, it requires some effort to learn. It's 
all too common an occurence for people to buy a com¬ 
puter, learn to use one or two application programs, but 
put off learning anything about DOS. It won't take long 
for them to encounter a situation they can't handle. 

Item: An amateur historian learns to use a database 
program to record the names of all the Civil War veter¬ 
ans from a western state. One day, after months of data 
entry, the program refuses to index the database, report¬ 
ing that the disk is full. At a friend's suggestion, our ama¬ 
teur historian buys another fixed disk but, without 
knowing how to use DOS. can’t transfer the program or 
data to the new (larger) disk. 

Item: A parent buys a computer so the children 
can use it for school work, and learns to use Microsoft 
Works for word processing and household budgeting. 
Seeing an ad for some shareware programs, the parent 
buys several disks of software that really sound interest¬ 
ing, but can’t figure out how to get the programs on 
the fixed disk. 

Someone who uses a computer without at least a ru¬ 
dimentary knowledge of disks, hies, and basic DOS com¬ 
mands is flying blind. Sooner or later it will catch up 
with them. 

Tailoring with batch files 

Knowing how to use DOS not only lets you manage your 
system more effectively, it gives you access to one of the 
handiest features of DOS: batch files. As you probably 


know, batch files let you personalize your system by 
tailoring the startup procedure to your devices and 
programs, and by automating commands that you use 
frequently. 

Learning to write batch files takes some study and 
practice, just like learning to use any other program. 
Magiizines often include articles about batch files; entire 
books, in fact, have been written about them. Because of 
their importance, each issue of Inside DOS includes tips 
and techniques for writing batch files. If you haven’t yet 
written any batch files, take the time to hunt up some of 
the introductoiy articles and jump in. 

The IF batch command 

DOS includes a few commands specifically designed for 
use in batch files. One of the most useful is the IF com¬ 
mand, which lets you control how the batch file operates 
depending on a certain condition. The IF command lets 
you check three conditions: 

• whether a file exists 

• the value of the variable ERRORI.EVEL 

• whether two series of characters (strings) are 
the same 

A few examples show how useful the IF command can be. 

Does that file exist? 

Checking whether a file exists is a valuable tool. For ex¬ 
ample, Copy appears to be a fairly benign DOS com¬ 
mand, but it can be one of the most dangerous because 
it lets you erase a file without even knowing it. If you 
copy a file and tell DOS to give the copy (the target file¬ 
name) the same name as an existing file, DOS dutifully 
replaces the existing file with the new copy and simply 
responds 1 File(s) copied. You haven’t got a clue that 
the existing file is gone; when you do discover it, you 
can’t even recover it with a file-recoveiy program. It’s 
gone forever. 

You can protect yourself against that sort of pilot 
error by writing a batch file that won’t copy the file if 
the target file already exists. Such a batch file (we’ll call 
it SAFECOPY.BAT) would take two parameters, just like 
the Copy command: The first (referred to as %1 in the 
batch file) names the source file and the second (%2) 
names the target file. SAFECOPY.BAT requires a single 
IF command that copies the source file only if the tar- 
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get file doesn 't exist: 

if not exist %2 copy %1 %2 

To make SAFECOPY.BAT more useful, however, you’d 
want it to display a message if the target file exists and 
the source file isn’t copied. Figure A shows an improved 
version of SAFECOPY.BAT that does the job nicely. 

Figure A 


@echo off 

if exist %2 goto NOTSAFE 
copy %1 %2 
goto end 
:NOTSAFE 

echo File %2 exists and 
echo would be replaced by %1. 
echo FILE NOT COPIED. 

:END 


SAFECOPY.BAT protects you against accidentally copying over 
an existing file. 

To use this batch file to copy FEBSAI.ES.XLS to 
FEBSALES.SAV, you would type 

Osaf ecopy febsales.xls febsales.sav 

You can use wildcard characters with 
SAFECOPY.BAT, but wildcard characters in the target 
filename restrict its use. For example, suppose you 
made a copy ofFEBSAI.ES.XLS called FEBSALES.SAV as 
in the previous example, then decided to copy all files 
that begin with FEB and whose extensions are XLS to 
files with the same name whose extensions are SAV. 

You would type 

Osaf ecopy f eb* . xls * . sav 

but no files would be copied because there is already a 
file whose extension is SAV. 

Admittedly, SAFECOPY.BAT isn’t quite as flexible as 
the COPY command—but it’s a lot safer. 

What’s an ERRORLEVEL? 

DOS keeps track of a numeric value called ERRORLEVEL, 
which any program can set. DOS lets you check 
ERRORLE’YEL with the IF command, giving programs a 
way to communicate with you. This is of pretty limited 
value, because only a few commands (such as BACKUP 
and RESTORE) set ERRORLEVEL. 

But as the article on page 8 of this issue shows, it 
isn’t difficult to create a program that sets ERRORLEVEL 
to a value that identifies the last key that was pressed. 


This makes ERRORLEVEL more useful, because now you 
can write interactive batch files that change their opera¬ 
tion depending on which key is pressed. For more infor¬ 
mation on this technique, read the article on page 8, or 
refer to the article entitled “Soliciting Input in a Batch 
File,” which appeared in the September issue. 

Comparing Strings 

The last option of the IF command lets you check 
whether one string of characters is the same as another. 
One of the most common uses of this is to see what pa¬ 
rameters, if any, were typed with a batch command. This 
is pretty straightforward. For example, suppose you 
wanted a batch file to go to the label END if the first pa¬ 
rameter typed with the batch command was off, you'd 
use the following IF command: 

if %l==off goto end 

If the first parameter is anything other than off, 
DOS ignores the GOTO command and continues with 
whatever commands follow the IF command. 

But there’s an aesthetic problem: If no parameter 
was typed with the batch command, DOS displays Syn¬ 
tax error, then continues with the commands that fol¬ 
low the IF command. The message is not only unattrac¬ 
tive, it can be unsettling. 

There’s also a more serious problem: What if 
you want the batch file to do something only if no 
parameter is typed (or if one parameter is typed, but 
not two)? How do you check for the absence of a 
parameter? 

It’s fairly simple. Just put quotation marks around 
the replaceable parameter and the string you want to 
compare it within the IF command. If you want to 
check for the absence of a parameter (this is sometimes 
called a “null” parameter), compare the replaceable pa¬ 
rameter to two quotation marks with nothing between 
them. 

For example, the following IF command checks 
whether the first parameter is offznrX avoids the error 
message if there is no parameter: 

if "%l"=="off" goto end 

It’s just as easy to go to the label END if there is no pa¬ 
rameter at all: 

if "%1"=="" goto end 

As you gain experience with batch files, you’ll find 
that they can significantly improve the usability of your 
system, and the IF command is one of the most valuable 
tools in your batch file kit. I 
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BATCH FILE TECHNIQUE 


A better way to solicit input in a batch file 


The idea for this article and its accompanying Debug 
script was submitted by John C. Bowers of Alta Loma, 
California. 

I n a previous issue of Inside DOS, we showed you 
how to use Debug to create a program called 
KEYPRESS.COM, and then explained how to use 
that utility to solicit ayes or no response in a batch file 
(“Soliciting Input in a Batch File,” September 1990). 
Although this technique works well when you want to 
ask yes or no questions, you’ll sometimes want to ask 
questions that would require the user to press a key 
other than Y or N. For instance, you might want to ask 
a question that offers three or more possible responses, 
or you might want to use a letter that is more appropri¬ 
ate than Y or N (as in, “Press Q to Quit”). 

In this article, we’ll present a more sophisticated 
version of KEYPRESS.COM that overcomes some of 
the limitations inherent in the original version. For 
instance, our new KEYPRESS.COM will allow you to 
solicit for any alphabetic key (not just Y, N, or ESC). It 
also lets you specify the prompting message as an argu¬ 
ment to the KEYPRESS command. After we show you 
how to create the new KEYPRESS.COM using Debug, 
we’ll demonstrate how it’s used in a couple of sample 
batch files. 

Creating the new KEYPRESS.COM 

To create the new version ofKEYPRESS.COM, you’ll 
need to use the Debug script shown in Figure A. As you 
may recall from September, you should use a text editor 
(like Edlin) to create a text file that contains these Debug 
instructions. If you don’t know how to use a text editor 
to create the Debug script in Figure A, refer to the Sep¬ 
tember issue, which provides step-by-step instructions 
for using Edlin to create such a file. 

By the way, all of the Os in Figure A are zeros—not 
letter Os. Additionally, all the Is are number Is —not 
lowercase letter Zs. Finally, make sure you include a 
blank line after the letter q at the very bottom of the file. 

Once you’ve created the Debug script shown in 
Figure A, you’re ready to run Debug and create the file 
KEYPRESS.COM. Assuming you’ve named your script 
hie KEYPRESS.SCR, you’ll want to issue the command 

C> debug < keypress.scr 

Immediately, Debug will execute the instructions in the 
hie KEYPRESS.SCR, and will deposit into the current 
directory the hie KEYPRESS.COM. 

Once you’ve created KEYPRESS.COM, copy it into a 
directory whose name is on the path. That way, DOS will 


always be able to hnd and execute this hie when you call 
it from within a batch hie. 

Figure A 
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You con use this Debug script to create the new and improved 
KEYPRESS.COM. 

Using KEYPRESS.COM in a 
batch file 

Unlike the old version ofKEYPRESS.COM, which accepts 
no arguments, the new and improved KEYPRESS.COM 
lets you specify both the prompting message as well as 
the list of valid keys the user can press. The new com¬ 
mand takes the fonn 

keypress prompt [valldKeys] 

where prompt is the prompting message you want to 
display on the screen, and validKeys is the list of valid 
keys the user can press. For instance, if you want to dis- 
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play the prompting message Press Y or N: and accept 
only those two keys as a valid response, you would use 
the command 

keypress Press Y or N: [yn] 

As soon as the user presses a valid key, 
KEYPRESS.COM sets the value of the system variable 
ERRORLEVEL to the corresponding value shown in 
Table A. For instance, if the user presses Y (or y), 
KEYPRESS.COM will set ERRORI.EVEL equal to 25. 

Once you’ve used KEYPRESS.COM to collect your in¬ 
put, you can use a series of IF commands to check for val¬ 
ues of ERRORLEVEL and branch to the appropriate sec¬ 
tion of the batch file. Keep in mind, however, that you 
need to check for values of ERRORI.EVEL in descending 
order. That is, you need to check if ERRORLEVEL is equal 
to higher numbers first, and lower numbers second. If 
you check for the values of ERRORLEVEL in ascending 
rather than descending order, your IF statements won’t al¬ 
low DOS to branch properly. 

Table A 
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KEYPRESS.COM sets ERRORLEVEL to the value associated with 
the key you press. 

An example 

As an example, suppose you want to prompt the user to 
press A, B, or C, and then execute a specific sequence of 
commands depending on which key they press. To do 
this, you could use a batch file like the one shown in Fig¬ 
ure B. 

The first command in KEYTEST1.BAT 
@echo off 

simply tells DOS not to display the batch file’s commands 
as it executes them. (By the way, if you’re using version 
3.2 or earlier of DOS, you’ll need to omit the @ sign in 
front of the echo command.) The next command 

keypress Press A, B, or C:[abc] 


runs KEYPRESS.COM, which tells DOS to display the 
message 

Press A, B, or C:_ 

and to wait until the user presses A, B, or C (or a, b, or 
c). Because we supplied the argument [abc] to our 
KEYPRESS command, DOS will not execute the next 
command in the batch file until you press one of these 
three valid keys. 

Figure B 


@echo off 

keypress Press A, B, or C: [abc] 
if errorlevel 3 goto C 
if errorlevel 2 goto B 
if errorlevel 1 goto A 
:C 

echo: 

echo You selected C 
goto END 
:B 

echo: 

echo You selected B 
goto END 
:A 

echo: 

echo You selected A 
:END 


KEYTEST1.BATprompts the user to press A, B, or C, and then 
executes the appropriate sequence of commands. 

The remainder of the batch file takes the same form 
as the batch file we presented in our previous article on 
KEYPRESS.COM. The next three commands in 
KEYTEST1.BAT 

if errorlevel 3 goto C 
if errorlevel 2 goto B 
if errorlevel 1 goto A 

check to see if ERRORLEVEL is equal to 3, 2, or 1, respec¬ 
tively, and if so, they tell DOS to branch to the appropri¬ 
ate section of the batch file (the section that begins with 
the label .Y7, :B, or :A). Notice that we’ve followed the 
rule of checking for values of ERRORLEVEL in descend¬ 
ing order. 

Of course, the sections labelled :C and :B both end 
with the command 

goto end 

which tells DOS to skip directly to the last line in the 
batch file, thus ending the batch file’s execution. 
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When you mn KEYTEST1.BAT by typing 
C>keytestl 

and pressing DOS will display the message 
Press A, B, or C:_ 

If your press A (or a), you’ll then see the message 
You selected A 

Of course, if you mn the batch file again and press either 
B or C, DOS will tell you that you selected that key 
instead. 

Another example 

Now let’s suppose you want to prompt the user to press 
S (for Start), B (for Backup), or E (for Exit), and then 
execute the appropriate sequence of commands. Figure 
C shows a batch file that will do the job. 

Figure C 


@echo off 

keypress Press S (for Start), B (for Back 
up), or E (for Exit): [she] 
if errorlevel 19 goto S 
if errorlevel 5 goto E 
if errorlevel 2 goto B 
:S 

echo: 

echo You selected Start 
goto end 
:E 

echo: 

echo You selected Exit 
goto end 
:B 

echo: 

echo You selected Backup 
:END 


KEYTEST2.BATprompts the user to press S, B, or E, and then 
executes the appropriate sequence of commands. 

As you can see, this batch file has the same basic stmc- 
ture as the previous batch file. The only difference is that 
here we’ve used the command 

keypress Press S (for Start), B (for Back 
up), or E (for Exit): [sbe] 

to solicit for the letters S, B, or E. If you mn this batch 
file and press any key other than S, B, or E (or s, b, or e). 


DOS will simply beep and wait for you to press a valid 
key before it carries out any additional commands. 

Other forms of the KEYPRESS 
command 

If you want, you can omit the prompt argument from 
the KEYPRESS command and use an ECHO command to 
display the prompting message. For instance, if you want 
to solicit for the keys A, B, or C, you can use either the 
command 

keypress Press A, B, or C: [abc] 

or the commands 

echo Press A, B, or C 
keypress [abc] 

You’ll typically want to include the prompt argument 
in the KEYPRESS command, though, since DOS can exe¬ 
cute a single KEYPRESS command faster than an ECHO 
and KEYPRESS command pair. 

Additionally, if you want to accept any keys as valid 
options, you can omit the validKeys argument in your 
KEYPRESS command. In fact, if you want to accept the 
ESC key as a valid option, you must omit the validKeys 
argument. For instance, to solicit for the keys Y, N, or 
ESC, you’ll use the command 

keypress Press Y, N, or ESC: 

then follow that command with IF statements that check 
to see if ERRORLEVEL is equal to 27 (for ESC), to 25 (for 
Y), or to 14 (for N). 

Conclusion 

Although our September issue presented a useful 
utility program called KEYPRESS.COM, that version of 
KEYPRESS.COM had a couple of limitations. In this 
article, we’ve presented a more sophisticated version 
ofKEYPRESS.COM that overcomes a couple of those 
limitations, and we’ve demonstrated how to use this 
utility to solicit input in a batch file. I 


Inside DOS back issues 

Back issues oiInside DOS are a handy resource. If 
your: Inside DOS library is incomplete, you should 
invest in back issues. These issues are available for 
^4 each. To order back issues, call The Cobb Group 
at (800)223-8720 or (502)491-1900, or by FAX at 
(502)491-4200. A free index is available upon request. 
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BATCH FILE TIP 


Displaying a blank line 

'T hen you write a batch file that displays text 
/ on the screen, you’ll usually want to insert a 
▼ T blank line to make the text more attractive and 
easier to read. For instance, if you create a menu system 
for your computer, you’ll want to insert a blank line 
between the menu headings and the options on each 
menu. In this article, we’ll show you how to use the 
ECHO command to create a blank line in your batch files. 

The problem 

As you probably know, the ECHO command displays 
text on the screen. For example, the command 

echo Good Morning! 

displays the line 

Good Morning! 

As you may have discovered, however, you can’t echo a 
blank line to the screen by simply typing the command 

echo 

If you do this, DOS displays either the message ECHO is 
on or the message ECHO is Oj^ instead of displaying a 
blank line. 

The solution 

Fortunately, you can use the ECHO command to display 
a blank line by echoing one of DOS’ nonprinting charac¬ 
ters to the screen. All you have to do is immediately fol¬ 
low the word echo with the appropriate character. For 
versions 3.x or 4.x, all of the following commands will 
produce a blank line: 

echo. 
echo+ 
echo/ 
echo [ 
echo] 
echo: 

For earlier DOS versions, you’ll need to follow the 
ECHO command with one of these characters: 

tab 

comma 
line feed 
space 
semicolon 
equal sign 


in a batch file 

as well as a trailing space. Eor instance, under DOS 2.1 
you can produce a blank line by typing echo, immedi¬ 
ately followed by a tab and a space. (Notice that later ver¬ 
sions of DOS don’t care whether you follow the 
nonprinting character with a space, while earlier ver¬ 
sions require the trailing space.) 

If you want to write a batch file that generates a 
blank line in nearly eveiy version of DOS, try typing the 
word echo, pressing the [E7] key, then typing a space. 
Pressing the [E7] key produces an @ sign in your batch 
file, but DOS interprets this character as a nonprinting 
character and therefore generates a blank line. 

An example 

Eigure A shows a sample batch file that displays two lines 
of text separated by a blank line. 

Figure A 


@echo off 
els 

echo Data Entry Menu 
echo] 

echo Enter your selection 


This botch file produces o heeding, o blonk line, ond o 
line of text. 

When you run the batch file in Eigure A, DOS will 
display the text 

Data Entry Menu 

Enter your selection 

Printing multiple blank lines 

You might think you could produce several blank lines 
in succession by following the word echo with several 
nonprinting characters. Unfortunately, this technique 
doesn’t work. For instance, if you include in a batch file 
the command 

echo]]]] 

and then run that batch file, DOS will display the charac¬ 
ters 

]]] 

instead of a blank line. For each blank line, then, you 
need to use a separate ECHO command that echoes a 
single nonprinting character, i 
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Protecting a file against changes using ATTRIB 

Continued from page 1 

If you attempt to edit the file’s contents using EDLIN, 
you’ll see the message 

File is READ-ONLY 

Finally, if you attempt to edit a read-only file’s contents 
using an application, you’ll receive some kind of error 
message when you attempt to save changes to the file 
from within the application. 

For example, suppose you want to make your 
AUTOEXEC.BAT file read-only so that no one (including 
you) can accidentally delete it. To do this, first move into 
the root directory and issue the command 

C: \>attrib *.* 

Immediately, DOS will show you the status of the files in 
the root directory 

A C:\COMMAND.COM 

A C:\AUTOEXEC.BAT 

A C:\CONFIG.SYS 

As you can see, the letter/? does not appear next to the 
file AUTOEXEC.BAT, indicating that its read-only attri¬ 
bute is turned off. 

Now, turn on AUTOEXEC.BAT’s read-only attribute 
using the command 

C: \>attrib +r autoexec.bat 

At this point, if you issue the command 

C: \>attrib *.* 

DOS will display the letter R next to the file 
AUTOEXEC.BAT to indicate that the file is now read¬ 
only. In other words, no one will be able to modify your 
AUTOEXEC.BAT file unless they first use the ATTRIB 
command to turn off that file’s read-only attribute. 

Removing read-only protection 

To remove a file’s read-only status, (in other words, to 
turn off its read-only attribute), issue the command 


attrib -r filename 

where filename is the name of the file you want to 
unprotect. Once you’ve turned off a file’s read-only at¬ 
tribute, of course, you won’t see the letter/? next to its 
name when you use the ATTRIB command to display 
the file’s read-only status. 

For example, to turn off the AUTOEXEC.BAT file’s 
read-only attribute, issue the command 

C: \>attrib -r autoexec.bat 

Once you’ve issued this command, DOS will allow you 
to modify or delete AUTOEXEC.BAT, and will remove 
the letter R next to its name when you list it using the 
ATTRIB command. 

By the way, if you explore the directories on your 
hard drive, you might discover that some of your appli¬ 
cation program files are read-only. If you attempt to 
remove an application from your hard disk by deleting 
the entire directory in which it’s installed, you’re likely 
to find that DOS won’t delete some of the files in that 
directory until you use the ATTRIB command to turn 
off those files’ read-only attributes. Anytime you at¬ 
tempt to delete a file and see the message Access de¬ 
nied, you’ll know to turn off that file’s read-only at¬ 
tribute using ATTRIB. 

Notes 

If you plan to use ATTRIB to protect some of your files, 
you’ll want to remember a couple of important points. 
First of all, ATTRIB isn’t a great security feature—if 
someone really wants to delete a file you’ve made read¬ 
only, all they have to do is use the ATTRIB command to 
turn off its read-only attribute. Therefore, ATTRIB is 
most useful for protecting against accidental deletions 
or modifications. 

Additionally, if you make yourAUTOEXEC.BAT and 
CONFIG.SYS files read-only, you might run into prob¬ 
lems when you install new applications. Most applica¬ 
tions offer a Setup or an Install program that automati¬ 
cally makes some changes to AUTOEXEC.BAT and 
CONFIG.SYS. For this reason, if you plan to make these 
two files read-only, remember to turn off their read¬ 
only attribute before you run a new application’s Setup 
or Install program. I 
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